https://sandbox-portal.tidypay.com/api/v01/customers/[customer-id]/[subscriptions]/[subscription-id]
Allows to manage the specified subscription.
Resource URL | Description |
---|---|
https://sandbox-portal.tidypay.com/api/v01/customers/[customer-id]/[subscriptions]/[subscription-id]/[adjustments] | Provides access to the adjustments associated with the specified subscription. |
Method: GET | Implicit: No | Returns: Subscription * |
Consumes: xurl | Produces: json, xml, xurl | |
Cancels the subscription right away or on the specified date.
|
# | Name | Type | Required | Default | Description |
---|---|---|---|---|---|
01 | effectiveDate | Date | Yes |
Date when the subscription is going to be canceled. |
|
02 | note | String | No |
Any notes related to the cancelation of the subscription. |
Method: GET | Implicit: No | Returns: Subscription * |
Consumes: xurl | Produces: json, xml, xurl | |
Freezes the subscription for the specified period.
|
# | Name | Type | Required | Default | Description |
---|---|---|---|---|---|
01 | effectiveDate | Date | Yes |
Date when the subscription is going to be frozen. The date must be in future and correspond to the subscription billing date. |
|
02 | length | Integer | Yes |
Number of the payments for which the subscription is going to be frozen. |
|
03 | note | String | No |
Any notes related to the freeze of the subscription. |
Method: GET | Implicit: Yes | Returns: Subscription * |
Consumes: xurl | Produces: json, xml | |
Returns settings of the subscription specified in the request.
|
Method: POST | Implicit: Yes | Returns: Subscription * |
Consumes: json, xml | Produces: json, xml | |
Updates the subscription with the specified values of the note and paymentOptionId fields.
|
# | Name | Type | Required | Default | Description |
---|---|---|---|---|---|
01 | object | Subscription * | Yes |
Information about the subscription transaction. |
Method: GET | Implicit: No | Returns: Subscription * |
Consumes: xurl | Produces: json, xml, xurl | |
Pauses the subscription right away or on the specified date.
|
# | Name | Type | Required | Default | Description |
---|---|---|---|---|---|
01 | effectiveDate | Date | Yes |
Date when the subscription is going to be put on pause. |
|
02 | note | String | No |
Any notes related to the pausing of the subscription. |
Method: GET | Implicit: No | Returns: Subscription * |
Consumes: xurl | Produces: json, xml, xurl | |
Uncancels the specified subscription.
Can be applied only to the subscriptions that have not been canceled yet. |
Method: GET | Implicit: No | Returns: Subscription * |
Consumes: xurl | Produces: json, xml, xurl | |
Unfreezes the specified subscription.
Can be applied only to the subscriptions that have been previously frozen. |
Method: GET | Implicit: No | Returns: Subscription * |
Consumes: xurl | Produces: json, xml, xurl | |
Unpauses the specified subscription.
Can be applied only to the subscriptions that have been previously paused. |